home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / SCGetScannerRes.z / SCGetScannerRes
Encoding:
Text File  |  1998-10-30  |  6.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSCCCCGGGGeeeettttSSSSccccaaaannnnnnnneeeerrrrRRRReeeessss((((3333))))               IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                SSSSCCCCGGGGeeeettttSSSSccccaaaannnnnnnneeeerrrrRRRReeeessss((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SCGetScannerRes, SCGetMinMaxRes - Determining the resolutions supported
  10.      by a scanner driver
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccaaaannnnnnnneeeerrrr....hhhh>>>>
  15.  
  16.      iiiinnnntttt SSSSCCCCGGGGeeeettttSSSSccccaaaannnnnnnneeeerrrrRRRReeeessss((((SSSSCCCCAAAANNNNNNNNEEEERRRR ****ssss,,,, iiiinnnntttt mmmmeeeettttrrrriiiicccc,,,, ffffllllooooaaaatttt ********xxxxrrrreeeessss,,,,
  17.                          ffffllllooooaaaatttt ********yyyyrrrreeeessss,,,, iiiinnnntttt ****nnnnrrrreeeessss))));;;;
  18.  
  19.      iiiinnnntttt SSSSCCCCGGGGeeeettttMMMMiiiinnnnMMMMaaaaxxxxRRRReeeessss((((SSSSCCCCAAAANNNNNNNNEEEERRRR ****ssss,,,, iiiinnnntttt mmmmeeeettttrrrriiiicccc,,,, ffffllllooooaaaatttt ****mmmmiiiinnnnxxxx,,,, ffffllllooooaaaatttt ****mmmmiiiinnnnyyyy,,,,
  20.                         ffffllllooooaaaatttt ****mmmmaaaaxxxxxxxx,,,, ffffllllooooaaaatttt ****mmmmaaaaxxxxyyyy))));;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s queries the scanner driver _s about the native resolutions
  24.      supported.  These are the resolutions which when used for scanning will
  25.      yield the highest quality image output.
  26.  
  27.      _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s makes *_x_r_e_s and *_y_r_e_s point to arrays of floating point
  28.      numbers, representing pairs of horizontal and vertical native
  29.      resolutions.  _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s sets *_n_r_e_s to the number of elements in
  30.      each of _x_r_e_s and _y_r_e_s.  _m_e_t_r_i_c should be passed in as either SSSSCCCC____IIIINNNNCCCCHHHHEEEESSSS or
  31.      SSSSCCCC____CCCCEEEENNNNTTTTIIIIMMMM, depending on whether the resolution is desired in pixels per
  32.      inch or pixels per centimeter.
  33.  
  34.      Some scanners support all resolutions within the bounds given by
  35.      _S_C_G_e_t_M_i_n_M_a_x_R_e_s (see below) equally well.  For such scanners, *_n_r_e_s will
  36.      be 0 after a call to _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s.
  37.  
  38.      _S_C_G_e_t_M_i_n_M_a_x_R_e_s fills in *_m_i_n_x with the smallest resolution supported in
  39.      the horizontal direction, *_m_i_n_y with the smallest resolution supported in
  40.      the vertical direction, *_m_a_x_x with the largest resolution supported in
  41.      the horizontal direction, and *_m_a_x_y with the largest resolution supported
  42.      in the vertical direction.  Use _m_e_t_r_i_c to specify either SSSSCCCC____IIIINNNNCCCCHHHHEEEESSSS or
  43.      SSSSCCCC____CCCCEEEENNNNTTTTIIIIMMMM for the units.
  44.  
  45.      The scanner driver must support any horizontal resolution between *_m_i_n_x
  46.      and *_m_a_x_x, and it must support any vertical resolution between *_m_i_n_y and
  47.      *_m_a_x_y.  Specifying a resolution outside these limits will yield
  48.      unpredictable results.  If the resolution specified is not a resolution
  49.      pair returned by _S_C_S_c_a_n_n_e_r_R_e_s, image quality may suffer.  See _S_C_S_e_t_u_p(3)
  50.      for more information on setting the scanning resolution.
  51.  
  52. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  53.      _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s and _S_C_G_e_t_M_i_n_M_a_x_R_e_s return 0 if they are successful, and
  54.      -1 if an error occurs.  If an error does occur, SCerrno will be set to
  55.      indicate the reason for failure.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSCCCCGGGGeeeettttSSSSccccaaaannnnnnnneeeerrrrRRRReeeessss((((3333))))               IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                SSSSCCCCGGGGeeeettttSSSSccccaaaannnnnnnneeeerrrrRRRReeeessss((((3333))))
  71.  
  72.  
  73.  
  74. EXECUTION ERROR CODES
  75.      _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s and _S_C_G_e_t_M_i_n_M_a_x_R_e_s will fail under the following
  76.      circumstances.
  77.  
  78.      SCEBADMETRIC             Unsupported metric
  79.  
  80.      SCEDEV                   Scanner driver error
  81.  
  82.      SCECOMM                  Error communicating with scanner driver
  83.  
  84. WWWWAAAARRRRNNNNIIIINNNNGGGG
  85.      The memory pointed to by *_x_r_e_s and *_y_r_e_s after a call to _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s
  86.      belongs to _l_i_b_s_c_a_n(3) and should not be modified by the calling program.
  87.      Nor should any assumptions be made about its values after subsequent
  88.      calls to _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s; in other words, it should be copied to memory
  89.      owned by the calling program before future calls to _S_C_G_e_t_S_c_a_n_n_e_r_R_e_s.
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      _l_i_b_s_c_a_n(3), _S_C_S_e_t_u_p(3).
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.